home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / bbs / hs_13.lha / Hack&Slash.doc < prev    next >
Text File  |  1992-12-12  |  12KB  |  242 lines
  1.                                 Hack & Slash
  2.                                 by Rob Hurst
  3.                                 Mark Montminy
  4.                                & Lonnie Watson
  5.  
  6. Installation:
  7.  
  8.    Hack & Slash should be placed in it's own directory.  I'd suggest locating
  9.    it in your main doors directory, but it's fully up to you.  No assigns
  10.    are necessary (more doors should be so kind), it will find it's files
  11.    according to the path it was launched from.
  12.  
  13.    (door programmers, read argv[0] and put an end to this assign nonsense!)
  14.  
  15.    Extract the archive with it's full path, and all files will be placed where
  16.    they belong for proper execution of the game.
  17.  
  18. Launching Hack & Slash:
  19.  
  20.    Depending on your BBS system, this will be different.  Most BBS' will be
  21.    running in standard i/o mode.  Do whatever magic is required of your BBS
  22.    system to start the game as a standard CLI program.  H&S expects a CTRL-C
  23.    break signal upon carrier loss or timeout, and will exit cleanly.
  24.    The command line should be:
  25.  
  26.    drive:doorpath/hack&slashpath/hack&slash <options> user_id
  27.  
  28.    Note the user_id.  This IS needed.  It may be the user's name, handle,
  29.    phone number, user number, or anything else UNIQUE to each user.  The game
  30.    uses it's own "handles" and simply uses this as a means to identify the
  31.    user playing.  It will read everything after the options as the user_id,
  32.    so the name need not be enclosed in "", or any other such nonsense.
  33.  
  34.    Options:
  35.  
  36.       -c Disables "back to back" plays.  A user must wait till another user
  37.          plays (or midnight is crossed) before playing again.  It helps keep
  38.          the game fair.  Without it, users can play as many turns as they have,
  39.          in a row.
  40.          Default is off, back to back plays are allowed.
  41.  
  42.       -e No character echo.  Probably a useless option.  It simply disables
  43.          echoing back what the user types.  It was added while trying to make
  44.          H&S run as a STDIO door under Xenolink, since Xenolink does the
  45.          echoing itself.  Seeing double just didn't cut it.  Nor did running
  46.          H&S as a CLIdoor under Xenolink, but the option was left in anyway.
  47.  
  48.       -x Run in Xenolink mode.  This forces H&S to run as a XenolinkDoor under
  49.          Xenolink since CLIdoor just had too many problems.  Standard Xenolink
  50.          syntax applies.  Note that this MUST be followed immediately with a
  51.          ~20 in order to work, ie -x~20.
  52.          The entry I use is:
  53.  
  54.             XenolinkDoor "^30000^1Hack&Slash/Hack&Slash -x~20 ~100"
  55.  
  56.    Hack & Slash should only be played by one node at a time.  A locking
  57.    mechanism has been used ensure that only one copy is in use at a time.
  58.    
  59.    When Hack&Slash starts up, it will take the base directory name, and create
  60.    an ENV variable with that name.  It will check for the existance of this
  61.    ENV before running.  If found, it means another copy is in use.  A message
  62.    will be displayed and the door will exit.  It it's not found, it is
  63.    created and the game starts.
  64.  
  65.    Note that you CAN have more than one H&S game going at once as long as
  66.    they each have thier own complete set of data files and executable in
  67.    seperate directories.
  68.  
  69. Monsters and Such:
  70.  
  71.    Picture file handling has changed since version 1.2.  Due to there being
  72.    100 monsters, I decided to break up the pictures into seperate dirs.
  73.    Currently in use is:
  74.  
  75.    Pics/Dungeon/
  76.       <MonsterName>.(ANS|TXT) - Monsters found in the dungeon
  77.       Cleric.(ANS|TXT) - Cleric found in the dungeon
  78.       Dungeon(N|W|E).(ANS|TXT) - Dungeon room pics
  79.    Pics/Arena/
  80.       <MonsterName>.(ANS|TXT) - Monsters found in the arena
  81.       Summoned Demon.(ANS|TXT) - Demon found in the arena
  82.    Pics/Player/
  83.       <Class Name>.(ANS|TXT) - pictures for players based on class
  84.    Pics/User/
  85.       <PlayerHandle>.(ANS|TXT) - picture for an individual user
  86.                                  (overrides PlayerPic)
  87.  
  88.    The <>should be replace with the name of the monster as seen in config.
  89.    ArenaMonsters are found in the arena (amazing eh?) and DungeonMonsters
  90.    (you guessed it) are found in the dungeon.  The PlayerPic is shown whenever
  91.    you do battle with another user in the arena.
  92.  
  93.    To be added still are the SeaMonsters and User Ships in the Naval section.
  94.  
  95. About Hack & Slash:
  96.  
  97.    Hack & Slash started life (in door form) as XenoRPG for Xenolink BBS.
  98.    XenoRPG was ported from Rob Hurst's RPGBBS program, which was a re-write
  99.    by Rob, of an AppleII BBS called TProBBS.  Rob was nice enough to port
  100.    this game to a Xenolink Door, and has turned the source over to me to
  101.    maintain.  Any changes I make, will be minor at best.  I don't want to
  102.    make major mods to the game, as it will make future merges of new
  103.    features Rob adds much harder.
  104.  
  105.    When I decided to switch from Xenolink, naturally XenoRPG had to come
  106.    with me (my users would have revolted).  The name didn't fit a "generic"
  107.    door, so it was renamed to Hack & Slash, after Rob's BBS.  Since Rob had
  108.    made so many changes to RPGBBS, we felt it was time for a re-port.  Several
  109.    hours, a few gurus, and a few Cokes later, Hack & Slash loaded.  Rob then
  110.    graciously handed the code back to me to continue massaging it for door
  111.    usage.
  112.  
  113. Docs?:
  114.  
  115.    You're reading them!  Docs are sparse, mainly because I hate writing them.
  116.    The game has online documentation for rules of play.  It's suggested
  117.    that you read them.  Any other documentation is sparse at best.  Docs
  118.    should be available for the config utility by the time you read this, and
  119.    the original RPGBBS docs are included for further reading enjoyment.
  120.  
  121. Registration:
  122.  
  123.    H&S is being released as Shareware.  As such, you are required to send in
  124.    a registration fee of $20.
  125.  
  126.    Registration gets you a key which allows you to procede beyind level 15
  127.    up to level 99 (bet you were thinking it was real easy to become Immortal).
  128.    It is after level 15 that magic starts to kick in, and things get harder.
  129.    The game is gaining immense popularity, and is well worth the $20 fee.
  130.    Registration also unlocks the config utility that allows you to edit the
  131.    various data files used by the game.  Just about EVERY attribute of the
  132.    game can be edited with config.
  133.    
  134.    To register, fill out the included form and return it to the address on
  135.    the form.  Payment methods, as well as methods for obtaining the kay are
  136.    listed on the form.
  137.  
  138.    **NOTE**
  139.    Do NOT spend the extra money for FedEx/Overnight mail!!!  This requires
  140.    that I go to the post office to pick it up.  Since my PO hours are from
  141.    8-4 and I leave for work at 7 and get home at 6, I can't get there 'till
  142.    the weekend!  Meaning, you wasted your money!
  143.  
  144. Note to XenoRPG owners:
  145.  
  146.    If you're a registered owner of XenoRPG, there is a utility included called
  147.    X2H.  Read the included docs for usage.  This will convert your XenoRPG.reg
  148.    file to a Hack&Slash.License file for you.
  149.  
  150. Changes:
  151. v1.3  12-12-92
  152. - Finally fixed my argument parsing bug.  VERY VERY stupid mistake on my part :(
  153.   Pointed out by a co-worker.  I felt like quite the dunce.
  154. - Since I had it on hold, I spiffed up the dungeon!  Now sporting 3D maps!
  155. - Added the cleric pic to the dungeon.
  156. - Made the options prompt in the dungeon "smart".  It only prompts for valid
  157.   directions now.
  158. - Change the "lock" method AGAIN.  I think this is final.  Should work well
  159.   for everyone.  It uses the base directory name as the ENV name.
  160. - Dungeon graphics are not shown in expert mode (at request of a few 1200 baud
  161.   callers).
  162. - New graphics, new graphics naming system.  Went to using the names instead
  163.   of numbers.  It was too difficult to edit the graphics by number :)
  164. v1.3  12-03-92 (internal, never released)
  165. -Fixed yet another option parsing bug(?) -c didn't always work.
  166. -Moved the pics added in 1.2 to thier own directory.
  167. -Went back to ENV:H&S for locking scheme.
  168. -Fixed ArenaMonster pics to allow ArenaMonsterD.??? for the Demon pic.
  169. -Added UserPic??.???  When fighting another player, it will look for a
  170.  UserPic for that player's ID and display it if found, else it will fall
  171.  back to displaying PlayerPic.??? (requested by Wim Rumping)
  172. -Added the "Froboz Magic Mailbox" at the request of Steve Cole.  Players
  173.  will be rewarded 1-5 gold pieces for every line of a message over 5 chars.
  174.  This was done to spur message activity in the game.
  175. -Updated Config to recognise the new Pic directory.
  176. -Updated X2H to work :)  (I was compiling it with NoUnsignedChars :(
  177. v1.2  11-21-92
  178. -Fixed a bug in the -x option parsing.  No idea why it wouldn't work for
  179.  anyone but me?  I changed the option parsing, hopefully it's fixed.
  180. -Added monster and player pics.  See docs for info.
  181. -Changed locking mechanism.  With the ENV method, it was not possible for
  182.  more than one game to be run at a time.  Now more than one game can be run
  183.  but still only one copy of each game at a time.
  184. v1.1  11-13-92
  185. -Whew, I think it's finally ready for a release.  A few very bizarre bugs held
  186.  it up MUCH longer than anticipated!
  187. v1.0  10-26-92
  188. -Really fixed the bug where the door wouldn't exit under Xenolink.
  189.  Changes too numerous to list.  This is just a good place to start tracking
  190.  H&S changes.
  191. Hack & Slash re-port 10-03-92
  192. v1.4  9-30-92
  193. -Fixed the "XenoRPG's still running" bug!!  And there was MUCH rejoicing!
  194.  Had to crack open a Killian's Red to celebrate this one.  Note to any
  195.  aspiring door programmers, do your CheckCarrier() AFTER your user input!
  196. -Changed alot of the internal functions to Xenolink functions.  Menus are
  197.  now displayed with Xeno's more propmts, and are able to use ~ codes within
  198.  (only MENU files, not the Announcement or Auto-Message).  All menu pages
  199.  should have the @ as the 1st character to prevent the MORE prompt at the
  200.  end.
  201. -Changed the "cripple" method.  The Dungeon and Naval section are now fully
  202.  functional.  Instead, you are limited to 15 levels of play, and are then
  203.  forced to re-roll.
  204. -The Announcement should only be displayed if there IS one.  If the file is
  205.  missing, it should be skipped over, along with the banner.
  206. -Maybe a few others, but none that stand out in my (admittedly terrible)
  207.  memory.
  208.  
  209. v1.3b 8-22-92
  210. -Change the number display back to scientific notation.  Once people saw
  211.  the numbers in long form, they seemed to like the scientific notation
  212.  better.
  213. -Fixed a typo in the Naval battle section.
  214.  
  215. v1.3a 8-20-92
  216. -Made the back-to-back call restriction optional.  if the ENV variable
  217.  RPGCALLBACK is set, users will be unable to play until another person
  218.  plays.  If it is not set, the game will play as it did before.  This
  219.  also allows you to easily toggle this feature via a cron event so that
  220.  during slow times of the day, you can turn it off, and turn it back on
  221.  when you have alot of callers.
  222. -Fixed the Experience display.
  223. -Changed the display of large numbers so that it doesn't use scientific
  224.  notation anymore.  (I think)
  225.  
  226. v1.3 8-19-92
  227. -Added more external menus
  228. -Fixed the menu fallback to .txt if no .gr* is available
  229. -Added full .gr* menu support, previously only recognised .gr1
  230. -Removed "getuser_inside" debug string
  231. -Made it into 1 exe for easier distribution
  232. -Added the time remaining to all menu prompts
  233. -Changed it so that users must wait for someone else to play before they
  234.  can play again, to give others a better chance to catch up.
  235.  
  236. v1.2 8-9-92
  237. -Fixed the 68K Software error when Jousting or attacking a player.
  238. -Added ANSI support (more will be added later).
  239. -XenoRPG recognises a user's expert mode setting.  Menu will act accordingly.
  240. -Fixed a bug where all callers were considered the 0th caller and given money.
  241. -Added registration key.
  242.